SftTree/OCX 7.0

SftTreeItems.ItemImageExpanded Property

Softel vdm, Inc.

Defines the default graphic used to display an expanded item's item image.

Syntax       

Get

VB.NET

refImageObj = object.ItemImageExpanded  As SftPictureObject

VB

Set refImageObj = object.ItemImageExpanded  As SftPictureObject

C#.NET

SftPictureObject refImageObj = object.ItemImageExpanded;

VC++

ISftPictureObject* refImageObj = object->ItemImageExpanded;
ISftPictureObject* refImageObj = object->GetItemImageExpanded();

C

HRESULT object->get_ItemImageExpanded(ISftPictureObject** refImageObj);

Delphi

refImageObj := object.ItemImageExpanded  : ISftPictureObject;

Put

VB.NET

object.ItemImageExpanded = refImageObj  As SftPictureObject

VB

object.ItemImageExpanded = refImageObj  As SftPictureObject

C#.NET

SftPictureObject object.ItemImageExpanded = refImageObj;

VC++

ISftPictureObject* object->ItemImageExpanded = refImageObj;
void object->PutItemImageExpanded(ISftPictureObject* refImageObj);

C

HRESULT object->put_ItemImageExpanded(ISftPictureObject* refImageObj);

Delphi

object.ItemImageExpanded := refImageObj  : ISftPictureObject;

object

A SftTreeItems object.

refImageObj

Defines the default graphic used to display an expanded item's item image.

Comments

The ItemImageExpanded property defines the default graphic used to display an expanded item's item image.

The ItemPictureExpanded property is used to define the default item graphic displayed for an expanded item, which is currently expandedItem graphics are not shown until the properties Items.ItemImageExpandable, Items.ItemImageExpanded and Items.ItemImageLeaf define valid graphics.

Sample bitmaps can be found in the directory \Program Files\Softelvdm\SftTree OCX 6.0\Images.  E.g., ItemExpD.bmp and ItemExpD2.bmp contain suitable sample images for the ItemImageExpanded property.

When using fixed height items (see Items.Style), all graphics used in a tree control as Item.Image, Items.ItemImageExpandable, Items.ItemImageExpanded and Items.ItemImageLeaf properties at the same time must be the same size (height and width).  The dimensions of the graphics are used to calculate the minimum dimension for items, so graphics used as item graphics are never clipped vertically.  To change the item graphic size, all item graphics must be removed first using the Items.ClearItemImages method.

When using variable height items (see Items.Style), the graphics used can be of varying size.  The item height is adjusted automatically, so graphics are never clipped vertically.

If an item is disabled (see Item.Enabled property), the graphic is drawn in a "grayed" fashion, if it is based on a bitmap. Other image types, like color samples, .NET image objects, etc., must be explicitly replaced with a grayed image if a different rendering of a disabled image is desired.

The ItemPictureExpanded property can be set to the value Nothing (NULL).  Item graphics are then no longer displayed.  The Item.Image properties remain unchanged.

The Items.ItemImageAlign property can be used to align item graphics on lower levels with higher level cells.

The VAlignStyle property can be used to define the vertical alignment of item graphics.

See Also  SftTreeItems Object | Object Hierarchy


Feedback / comments / error reports for this topic
© 2015 - Softel vdm, Inc. - www.softelvdm.com